home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u255.dms / in.adf / IFF2PS / iff2ps.1.cat < prev    next >
Encoding:
Text File  |  1989-06-03  |  7.5 KB  |  198 lines
  1.  
  2.  
  3.  
  4. iff2ps(1)                 USER COMMANDS                 iff2ps(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      iff2ps - IFF to PostScript filter
  10.  
  11. SYNTAX
  12.      iff2ps [ options ] [ IFFfile [ PSfile ] ]
  13.  
  14. DESCRIPTION
  15.      The iff2ps command takes an IFF ILBM file as input and  pro-
  16.      duces  a  PostScript  file  that may be sent to a PostScript
  17.      printer (e.g., an  Apple  LaserWriter)  for  printing.   The
  18.      image   portion   in  the  PostScript  file  is  compressed.
  19.      Decompression is done by the PostScript  interpreter  within
  20.      the printer.  If no files are given on the command line, the
  21.      standard input is read, and the standard output  is  written
  22.      to.   If  only  one  file is given on the command line, then
  23.      that file must be an IFF file, and the  standard  output  is
  24.      written  to.  Note that you cannot specify a PostScript out-
  25.      put file and have standard input read.  The output file con-
  26.      forms  to  the  Adobe 2.0 file structuring conventions.  The
  27.      options may appear before or after the file names.
  28.  
  29.      The program correctly handles  any  ILBM  format.   Specifi-
  30.      cally,  the  image in the IFF file can be any size, can have     any number of bitplanes, and all CAMG view  modes  are  sup-
  31.      ported  (i.e.,  low  resolution, high resolution, interlace,
  32.      HAM, double playfield, and HALFBRITE).  However, it is noted
  33.      that  currently double playfield files are not printed quite
  34.      correctly since both fields  are  printed  on  top  of  each
  35.      other.
  36.  
  37.      The following options may be used to control the  formatting
  38.      of the image.
  39.  
  40.      -a        Append output to a previously produced  PostScript
  41.                file.  This options allows the placement of multi-
  42.                ple images on the same output page.   The  default
  43.                is FALSE.
  44.  
  45.      -c_n       Number of copies.  The practical  upper  limit  on
  46.                the  number of copies is governed by the number of
  47.                sheets which the printer paper tray will hold.  If
  48.                you  want  multiple  copies of the same image, use
  49.                this option instead  of  running  iff2ps  multiple
  50.                times  as  it  is orders of magnitude faster.  The
  51.                default value is 1.
  52.  
  53.      -e        This option enables  echoing  of  the  translation
  54.                progress.  The default is FALSE.
  55.  
  56.      -f        Use this option if the output file if to be encap-
  57.                sulated  and  used by some other application which
  58.                can import  PostScript  images.   The  default  is
  59.  
  60.  
  61.  
  62. Sun Release 3.5   Last change: October 31, 1988                 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. iff2ps(1)                 USER COMMANDS                 iff2ps(1)
  70.  
  71.  
  72.  
  73.                FALSE.
  74.  
  75.      -g_n       Number of gray shades to be used in the half-toned
  76.                image.   There  are  only four possible values for
  77.                the number of gray shades: 2, 4, 16, 256.  If this
  78.                option is omitted, the next number greater than or
  79.                equal to the number of colors in the IFF file will
  80.                be used.  For example: a 320 by 200 pixel by 5 bit
  81.                planes (32 colors) picture would  default  to  256
  82.                gray  shades  while  a  640x400x4 (16 color) image
  83.                would default to 16 gray shades.  If an image con-
  84.                tains  a  pure white color, it will be rendered as
  85.                pure white in the half-toned print.  To  obtain  a
  86.                half-toned   white  (99  percent  of  pure  white)
  87.                instead of pure white, enter the  number  of  gray
  88.                shades as a negative number.  Special effects (and
  89.                smaller output files) can be obtained by  choosing
  90.                fewer  gray  shades  than the numbers of colors in
  91.                the original  picture.   Choosing  2  shades  will
  92.                result  in  a high contrast image while choosing 4
  93.                shades for a picture with greater  than  4  colors
  94.                will result in a posterized effect.
  95.  
  96.      -n        Negative image.  Can be used with  any  number  of
  97.                gray shades.  The default is FALSE.
  98.  
  99.      -p        The image is printed  in  portrait  mode  if  this
  100.                option is selected.  The default is FALSE in which
  101.                case the image is printed in landscape mode.
  102.  
  103.      -r_n       This option specifies  the  rotation  angle.   The
  104.                image  is rotated _n degrees counterclockwise.  The
  105.                default is 0 degrees.
  106.  
  107.      -s_n,-t_n   These options  specify  the  x  and  y  coordinate
  108.                scales  in  printer  Points  (72 Points = 1 inch).
  109.                The defaults are 0, in which case the  scales  are
  110.                automatically  chosen  so  as  to give the largest
  111.                image for the current format.
  112.  
  113.      -x_n,-y_n   These options enable the placement of the  coordi-
  114.                nate  origin  at  a  specified  location  given in
  115.                printer Points.  The defaults are such as to  give
  116.                a  centered  image  on  the page regardless of the
  117.                current format.
  118.  
  119.      ?         This option will echo the command  format  to  the
  120.                screen.
  121.  
  122.      Defaults for all command line arguments can be specified  in
  123.      the  configuration file iff2ps.cfg which should be placed in
  124.      S:.  If iff2ps is run and a configuration file exists,  then
  125.  
  126.  
  127.  
  128. Sun Release 3.5   Last change: October 31, 1988                 2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. iff2ps(1)                 USER COMMANDS                 iff2ps(1)
  136.  
  137.  
  138.  
  139.      it  is  read  to set up the program's defaults.  Switches on
  140.      the command line, though, will always  override  the  confi-
  141.      guration switches.  The configuration file consists of lines
  142.      in which the initial character in each  line  specifies  the
  143.      command.   If the initial character is a space, an asterisk,
  144.      a pound sign, a semicolon, or  a  line  feed,  the  line  is
  145.      ignored.   This  makes  it  useful  for commenting the file.
  146.      White space following the command is optional.  Comments can
  147.      also  be  placed  on the individual lines after the complete
  148.      command is specified.
  149.  
  150. DIAGNOSTICS
  151.      If the IFF ILBM file makes use of a specific Amiga view mode
  152.      such  as  HAM,  HALFBRITE,  or  dual playfield, a CAMG chunk
  153.      should be present in the file.  If it is not  present,  then
  154.      iff2ps  must guess the the view mode.  In most circumstances
  155.      iff2ps will make the right guess and echo ``No  CAMG  chunk!
  156.      Guessing  ViewModes.''  to  the  screen.  If such files were
  157.      generated by  a  commercial  program,  the  user  is  highly
  158.      encouraged  to  contact the distributor of the software pro-
  159.      duct and complain about the  improper  IFF  file  generated.
  160.      Only through such efforts can we hope to see better software
  161.      on the Amiga.
  162.  
  163. BUGS
  164.      Dual playfield files are printed incorrectly.   Both  fields
  165.      are printed on top of each other without masking.
  166.  
  167. FILES
  168.      iff2ps.cfg     configuration file
  169.  
  170. SEE ALSO
  171.      tek2ps(1)
  172.  
  173. COPYRIGHT
  174.      Copyright (c) 1987, 1988 William Mason and Samuel  Paolucci.
  175.      All  rights  reserved.  This program can be freely redistri-
  176.      buted provided the documentation  accompanies  the  program,
  177.      and is not included with any commercial software without the
  178.      authors'  written  consent.   This  program  is  distributed
  179.      WITHOUT ANY WARRANTY.
  180.  
  181. AUTHORS
  182.      William Mason and Samuel Paolucci.  Special thanks to  Tomas
  183.      Rokicki  for  allowing  us to use his PostScript compression
  184.      routine.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194. Sun Release 3.5   Last change: October 31, 1988                 3
  195.  
  196.  
  197.  
  198.